home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 1 / BBS in a box - Trilogy I.iso / Files / MIDI / H-M / MidiLib Folder / MidiLib Documentation < prev    next >
Encoding:
Text File  |  1988-01-09  |  2.8 KB  |  68 lines  |  [TEXT/ttxt]
  1. MidiLib v1.00
  2. ©1988 by Michael Williams
  3.  
  4. MidiLib is a general purpose desk accessory which uses driver files to
  5. configure itself to send and receive MIDI SYSEX data to/from various MIDI
  6. devices.
  7.  
  8. These driver files are written in a script language which is similar to
  9. English in hopes that knowledgeable users may write their own drivers as
  10. new MIDI devices are introduced to the marketplace.
  11.  
  12. MidiLib should be installed using the FONT/DA MOVER utility provided with
  13. Apple system software.
  14.  
  15. Since MidiLib must commandeer the serial port (it always uses the modem
  16. port), its behavior may cause problems for some applications which don't
  17. police for this action.  I use MidiPaint which detects if a DA has stolen
  18. the serial port and steals it back (give your application a few seconds
  19. to recover when returning from MidiLib).  If all else fails, MidiLib should
  20. always work from Finder.
  21.  
  22. When first invoked, MidiLib disables the send/receive menu items.  When a
  23. driver has been successfully loaded, these items are enabled.  In an effort
  24. to provide the most utility to the user, the driver files are created with
  25. the type TEXT.  Many editors can import/export this file type.
  26.  
  27. A MidiLib driver consists of command lines which begin with a keyword and
  28. end with a carriage return.  The driver must contain a valid MidiLib ID
  29. followed by a valid DriverID.  It must also contain both Backup and Restore
  30. script markers and must end with the End script marker.
  31.  
  32. The driver command set is as follows:
  33.  
  34.     .MidiLib    <version#>    - MidiLibID
  35.     .DriverID    <4 char ID>    - DriverID (filetype)
  36.     .Backup                - Backup script marker
  37.     .Restore            - Restore script marker
  38.     .End                - End script marker
  39.     .Send        <hex><hex>*    - Send hex string
  40.     .SendFile    <# chars>    - Send from file
  41.     .Delay        <# ticks>    - Delay (tick = 1/60 sec)
  42.     .Match        <hex><hex>*    - Match incoming string
  43.     .WriteFile    <# chars>    - Write incoming chars to file
  44.  
  45. Drivers have been provided to serve as examples.  I like to divide my
  46. backups into two major categories: Voice Data and Setup Data.  That way
  47. I can trade voices without clobbering my particular setup.
  48.  
  49. The MT32 driver will backup/restore MT32 setups.  It requires that the
  50. MT32 Device ID be set to 17.  I have included a sample setup which sets
  51. the reverb to tape delay mode.  It also places Part 1 into multiple assign
  52. mode.
  53.  
  54. The TX81Z driver will backup/restore the 32 "I bank" voice definitions.
  55. It requires that the TX81Z be set to channel 11 (and the exclusive:on
  56. option be set).  I just got my TX81Z so I included a bank of factory voices
  57. in case someone wanted to use them for some unimaginable purpose.
  58.  
  59. I suggest placing MidiLib files in a dedicated folder.
  60.  
  61. If anyone has any questions, I can be reached via GEnie either by MAIL or
  62. at the MIDI forum.  I would welcome any suggestions for improvement.
  63.  
  64. Michael Williams
  65. 01/08/88
  66.  
  67. P.S. MidiLib was written in LightSpeed C.
  68.